共用方式為


Manage orders - Gets a list of product promotions.

取得合作夥伴的可用促銷。

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions?country={country}&segment={segment}

URI 參數

名稱 位於 必要 類型 Description
version
path True

string

country
query

string

國家/ 地區。

segment
query

string

區段。

要求標頭

名稱 必要 類型 Description
Authorization True

string

授權持有人令牌

ms-correlationid

string

用於在內部追蹤要求。 如果未提供 ms-correlationid,伺服器會為每個要求產生新的要求

MS-CV

string

用於在內部追蹤要求。 如果未提供 MS-CV,伺服器將會為每個要求產生新的要求

ms-requestid

string

用於要求等冪性。 如果未提供 ms-requestid,伺服器將會為每個要求產生新的要求

回應

名稱 類型 Description
200 OK

ResourceCollection[Contracts.V1.Models.ProductPromotion]

要求成功。 回應本文將包含合作夥伴的促銷清單。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

輸入遺失或無效。 回應本文會提供錯誤詳細數據。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

要求未通過驗證。 客戶端必須先向合作夥伴 API 服務進行驗證。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

要求已通過驗證,但因為呼叫端沒有叫用要求的許可權而遭到拒絕。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

找不到資源,或無法使用指定的輸入參數。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

合作夥伴 API 服務或其其中一個相依性無法滿足要求。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

定義

名稱 Description
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm
Link
ResourceAttributes
ResourceCollection[Contracts.V1.Models.ProductPromotion]
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]

Contracts.V1.Models.ProductPromotion

名稱 類型 Description
description

string

endDate

string

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string

Contracts.V1.Models.ProductPromotionPricingPolicy

名稱 類型 Description
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

名稱 類型 Description
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

名稱 類型 Description
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

名稱 類型 Description
billingCycle

string

duration

string

名稱 類型 Description
body

string

headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

名稱 類型 Description
etag

string

objectType

string

ResourceCollection[Contracts.V1.Models.ProductPromotion]

名稱 類型 Description
attributes

ResourceAttributes

items

Contracts.V1.Models.ProductPromotion[]

links

ResourceLinks

totalCount

integer

名稱 類型 Description
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

名稱 類型 Description
key

string

value

string